Skip to content

Add type hints to all functions in metrics.py #446#447

Open
Sidhant185 wants to merge 2 commits intomllam:mainfrom
Sidhant185:feat/add-type-hints-metrics
Open

Add type hints to all functions in metrics.py #446#447
Sidhant185 wants to merge 2 commits intomllam:mainfrom
Sidhant185:feat/add-type-hints-metrics

Conversation

@Sidhant185
Copy link
Copy Markdown

@Sidhant185 Sidhant185 commented Mar 20, 2026

Describe your changes

Add torch.Tensor, Optional[torch.Tensor] and bool type hints to all
function signatures and return types in neural_lam/metrics.py.

Functions updated:

  • get_metric
  • mask_and_reduce_metric
  • wmse, mse, wmae, mae, nll, crps_gauss

No logic changes were made — only type annotations were added.

Issue Link

closes #446

Type of change

  • 🐛 Bug fix (non-breaking change that fixes an issue)
  • ✨ New feature (non-breaking change that adds functionality)
  • 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • 📖 Documentation (Addition or improvements to documentation)

Checklist before requesting a review

  • My branch is up-to-date with the target branch
  • I have performed a self-review of my code
  • For any new/modified functions/classes I have added docstrings that clearly describe its purpose, expected inputs and returned values
  • I have placed in-line comments to clarify the intent of any hard-to-understand passages of my code
  • I have updated the README to cover introduced code changes
  • I have added tests that prove my fix is effective or that my feature works
  • I have given the PR a name that clearly describes the change, written in imperative form
  • I have requested a reviewer and an assignee

Checklist for reviewers

Each PR comes with its own improvements and flaws. The reviewer should check the following:

  • the code is readable
  • the code is well tested
  • the code is documented (including return types and parameters)
  • the code is easy to maintain

Author checklist after completed review

  • I have added a line to the CHANGELOG describing this change:
    • maintenance: add type hints to all functions in metrics.py

Checklist for assignee

  • PR is up to date with the base branch
  • the tests pass
  • (if the PR is not just maintenance/bugfix) the PR is assigned to the next milestone. If it is not, propose it for a future milestone.
  • author has added an entry to the changelog (and designated the change as added, changed, fixed or maintenance)
  • Once the PR is ready to be merged, squash commits and merge the PR.

@Sidhant185 Sidhant185 changed the title Add type hints to all functions in metrics.py Add type hints to all functions in metrics.py #446 Mar 20, 2026
@sadamov sadamov self-requested a review March 23, 2026 05:34
@sadamov sadamov added the enhancement New feature or request label Mar 23, 2026
@sadamov sadamov self-assigned this Apr 1, 2026
Copy link
Copy Markdown
Collaborator

@sadamov sadamov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good, just a few small things.



def get_metric(metric_name):
def get_metric(metric_name: str):
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

get_metric is missing a return type. The PR description says "all functions" but this one's incomplete. Since it returns one of the metric callables, something like this works:

Suggested change
def get_metric(metric_name: str):
def get_metric(metric_name: str) -> "Callable[..., torch.Tensor]":

You'd also need from collections.abc import Callable (or from typing import Callable) added to the imports.

@@ -1,8 +1,11 @@
# Standard library
from typing import Optional
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Project requires Python >= 3.10, so Optional from typing is a legacy alias. torch.Tensor | None is preferred. If you update the usages, this import can be dropped entirely.

Suggested change
from typing import Optional
from collections.abc import Callable

(if you also fix the get_metric return type above)

@sadamov
Copy link
Copy Markdown
Collaborator

sadamov commented Apr 1, 2026

CHANGELOG entry is missing

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add type hints to functions in metrics.py

2 participants